Recharges 充值

通过创建 recharge 对象,为用户的余额进行充值。充值完成后可以调用 user 对象查询接口,查询用户的余额。

  • 服务端在传 Recharge 对象到客户端前,请先使用各 SDK 自带的序列化方式(比如 Java 的 .toString())将对象转换成 JSON 字符串。
  • 此接口暂不支持跨境渠道。
属性描述
id string充值对象 ID,由 Ping++ 生成。
object string值为 "Recharge"。
app string对应 app 对象的 id,查看 如何获取App ID
created timestamp创建时间,用 Unix 时间戳表示。
livemode boolean是否是 live 模式。
amount int用户实际到账余额,单位为分(包含赠送金额和扣除用户手续费,例如充 100 送 20,则该值是 120;充 100 收 5 元用户手续费,则该值是 95)。
succeeded boolean是否已充值成功。
time_succeeded timestamp充值成功时间,用 Unix 时间戳表示。
refunded boolean是否存在退款(跟是否退款成功没有关系)。
user string充值目标 user 对象的 id,64 位以内。
from_user string充值来源 user 对象的 id,64 位以内。
user_fee int收取的用户手续费,单位为分,取值范围 0~1000000000。
charge object支付使用的 charge 对象。
balance_bonus object包含的 balance_bonus 对象。
refunds list包含的 refund 对象列表。
balance_transaction string关联的 balance_transaction 对象的 id
description string附加说明,最多 255 个 Unicode 字符。
metadata hash详见 元数据

示例对象

{
  "id": "2001706060000002372",
  "object": "recharge",
  "app": "app_1Gqj58ynP0mHeX1q",
  "created": "1496740128",
  "livemode": false,
  "amount": 1000,
  "succeeded": false,
  "time_succeeded": null,
  "refunded": false,
  "user": "test_user_02",
  "from_user": "test_user_01",
  "user_fee": 100,
  "charge": {
    "id": "ch_SejbHOrzbjvPunjHmD08SCi9",
    "object": "charge",
    "created": 1496740128,
    "livemode": false,
    "paid": false,
    "refunded": false,
    "reversed": false,
    "app": "app_1Gqj58ynP0mHeX1q",
    "channel": "upacp",
    "order_no": "20161000167",
    "client_ip": "127.0.0.1",
    "amount": 10000,
    "amount_settle": 10000,
    "currency": "cny",
    "subject": "测试订单007测试订单007&",
    "body": "订单内容007",
    "extra": {},
    "time_paid": null,
    "time_expire": 1496826528,
    "time_settle": null,
    "transaction_no": null,
    "refunds": {
      "object": "list",
      "url": "/v1/charges/ch_SejbHOrzbjvPunjHmD08SCi9/refunds",
      "has_more": false,
      "data": []
    },
    "amount_refunded": 0,
    "failure_code": null,
    "failure_msg": null,
    "metadata": {},
    "credential": {
      "object": "credential",
      "upacp": {
        "tn": "201409161028470000000",
        "mode": "01"
      }
    },
    "description": null
  },
  "balance_bonus": {},
  "refunds": {},
  "balance_transaction": "",
  "description": "",
  "metadata": {}
}